home *** CD-ROM | disk | FTP | other *** search
/ Technotools / Technotools (Chestnut CD-ROM)(1993).ISO / unix / compr20 / compr20.doc next >
Encoding:
Text File  |  1990-05-29  |  16.9 KB  |  411 lines
  1.     -----------------------------------------------------------------
  2.     compr20.doc - last modified Sat May 26 22:52:40 1990 CDT
  3.     -----------------------------------------------------------------
  4.     Universal archive utilities package - Mark B. Foster
  5.  
  6.     Differences from version 1.9 are signaled by a percent sign.  They
  7.     are summarized in the 'utility history' section of this file.
  8.  
  9.     -----------------------------------------------------------------
  10.     % The utilities were assembled using A86 v3.22.  Special thanks to
  11.     % Pat Myrto, Mike Arst, Patrick Lee, and Eric Isaacson.
  12.  
  13.     Feel free to contact me with suggestions or problems.  I receive
  14.     email at the following places:
  15.  
  16.         CompuServe: 72261,2531
  17.     %    Internet: 72261,2531@compuserve.com
  18.         GEnie: M.FOSTER3
  19.  
  20.     If you have renamed any of these utilities or any of the supported
  21.     compression programs, let me know and I will assemble a version
  22.     with the names you have chosen.
  23.  
  24.     Although the utilities have been extensively tested, and all known
  25.     bugs eradicated, I explicitly disclaim any warranty whatsoever for
  26.     them.  Any and all risk of using them is yours alone.
  27.  
  28.     -----------------------------------------------------------------
  29.     Introduction.
  30.     -----------------------------------------------------------------
  31.     This archive contains six extremely fast utilities that simplify
  32.     the routine chores of extracting from, freshening, deleting
  33.     from, and viewing file lists in compressed files:
  34.  
  35.         xt - extractor for zip, lzh, lzs, pak, arc, dwc, md, zoo,
  36.              sh, uue, tar, Z, sit, pit archives
  37.         fr - freshener for zip, lzh, lzs, pak, arc, zoo, dwc
  38.              archives
  39.     %    dl - deleter for zip, lzh, lzs, pak, arc, zoo, dwc
  40.     %         archives
  41.         vw - file lister for zip, lzh, lzs, pak, arc, dwc, md,
  42.              zoo, tar, sit, pit archives
  43.         mn - 'more' pipe (nansi.sys version) for use with vw, or
  44.              as a standalone filter
  45.         ma - 'more' pipe (ansi.sys version) for use with vw, or
  46.              as a standalone filter
  47.  
  48.     -----------------------------------------------------------------
  49.     Program syntax.
  50.     -----------------------------------------------------------------
  51.     xt usage: xt [-o -u] archive [filename{s}]
  52.  
  53.         -o  overwrite existing output files
  54.         -u  unlink (delete) archive(s) after file extraction
  55.  
  56.     -----------------------------------------------------------------
  57.     fr usage: fr [-c -s] archive [filename{s}]
  58.  
  59.         -c  set pak v2.x to use Crush for true-pak archives
  60.  
  61.         -s  set pkzip v1.1 to use Shrink
  62.             set pak to use Squash for arc-format archives
  63.  
  64.     The 'c' switch may be set as the default by changing the byte at
  65.     debug offset :0294 from 00 to ff.  The 's' switch may be set as
  66.     the default by changing the byte at offset :0295 from 00 to ff.
  67.  
  68.     -----------------------------------------------------------------
  69.     % dl usage: dl archive filename[s]
  70.  
  71.     -----------------------------------------------------------------
  72.     Vw usage: vw archive [filename{s}] [| mr]
  73.  
  74.     -----------------------------------------------------------------
  75.     mr usage: [vw archive |] mr [filename]
  76.  
  77.     This syntax is to be used after selecting either mn.com or ma.com
  78.     and renaming it 'mr.com'.
  79.  
  80.     -----------------------------------------------------------------
  81.     General notes for xt, fr, dl, vw.
  82.     -----------------------------------------------------------------
  83.     Archive extensions need not be specified.
  84.  
  85.     DOS wildcards and pathnames are supported.  For example, 'xt *' is
  86.     equivalent to 'xt *.*', 'xt foo*' to 'xt foo*.*', and so on.
  87.  
  88.     The '/' switch character may be used instead of '-'.
  89.  
  90.     The compression programs must reside in the same directory as the
  91.     utilities or on the path.
  92.  
  93.     These utilities return a nonzero errorlevel if an they encounter an
  94.     error during execution.
  95.  
  96.     A cryptic usage message may be viewed by entering 'xt', 'fr', 'dl',
  97.     or 'vw' with no parameters at the DOS prompt.
  98.  
  99.     The version id and usage message may be viewed with the command
  100.     'type n' (where 'n' is the utility name) at the DOS prompt.
  101.  
  102.     -----------------------------------------------------------------
  103.     Specific notes for xt, fr, dl, vw.
  104.     -----------------------------------------------------------------
  105.     Each of the tables in this section lists the programs supported by
  106.     these utilities and the switches passed to them.  A dot ('.')
  107.     indicates no arguments.  Blanks denote that an option is not used.
  108.  
  109.     -----------------------------------------------------------------
  110.     Pkzip/unzip notes.
  111.  
  112.     For pkzip.exe v1.1, fr defaults to Implode; the 's' switch sets
  113.     pkzip to use Shrink instead.
  114.  
  115.     +-------+------+----+-------+------+-------+----+----+
  116.     |  pgm  | vers | xt | xt -o |  fr  | fr -s | dl | vw |
  117.     +-------+------+----+-------+------+-------+----+----+
  118.     | pkzip | 1.1  |    |       |  -f  | -fes  | -d |    |
  119.     +-------+------+----+-------+------+-------+----+----+
  120.     |pkunzip| 1.1  | .  |  -o   |      |       |    | -v |
  121.     +-------+------+----+-------+------+-------+----+----+
  122.  
  123.     -----------------------------------------------------------------
  124.     Pak notes.
  125.  
  126.     With true-pak archives, fr sets pak.exe to use Distill by default.
  127.     The command 'fr -c' sets pak to use Crush instead.
  128.  
  129.     Pak requires about 165k of memory.  When 165k is not available,
  130.     the utilities abort with a status message.
  131.  
  132.     +-------+------+----+-------+----+-------+----+----+
  133.     |  pgm  | vers | xt | xt -o | fr | fr -c | dl | vw |
  134.     +-------+------+----+-------+----+-------+----+----+
  135.     |  pak  | 2.10 | e  | e /wa | f  | f /cr | d  | v  |
  136.     +-------+------+----+-------+----+-------+----+----+
  137.  
  138.     -----------------------------------------------------------------
  139.     Arc-format notes.
  140.  
  141.     Xt and vw look first for pkxarc.exe, then for pak.exe if pkxarc
  142.     is not found; fr and dl look first for pkarc, then for pak.exe.
  143.  
  144.     If pak is used for arc-format archives, fr sets pak to use Crunch
  145.     by default.  The command 'fr -s' sets pak to use Squash instead.
  146.  
  147.     The utilities are compatible with arc-format archives created
  148.     using pre-Crunch compression methods.
  149.  
  150.     Pkpak.exe and pkunpak.exe can be used by renaming them pkarc.exe
  151.     and pkxarc.exe respectively.
  152.  
  153.     When less than 165k of memory is available, xt and vw bypass pak
  154.     and look for pkxarc instead; fr and dl bypass pak and look for
  155.     pkarc.  An appropriate status message is displayed.
  156.  
  157.     +-------+------+----+-------+------+-------+----+----+
  158.     |  pgm  | vers | xt | xt -o |  fr  | fr -s | dl | vw |
  159.     +-------+------+----+-------+------+-------+----+----+
  160.     |  pak  | 2.10 | e  | e /wa | f /c | f /s  | d  | v  |
  161.     +-------+------+----+-------+------+-------+----+----+
  162.     | pkarc | 3.6  |    |       |  f   |       | d  |    |
  163.     +-------+------+----+-------+------+-------+----+----+
  164.     |pkxarc | 3.6  | .  |  -r   |      |       |    |-vv |
  165.     +-------+------+----+-------+------+-------+----+----+
  166.  
  167.     -----------------------------------------------------------------
  168.     Lharc and larc notes.
  169.  
  170.     For lzs archives xt, dl, and vw look first for larc.exe, then
  171.     for lharc.exe if larc is not found.  Because larc and lharc use
  172.     incompatible compression methods, fr looks only for larc.
  173.  
  174.     +-------+------+------+-------+----+----+----+
  175.     |  pgm  | vers |  xt  | xt -o | fr | dl | vw |
  176.     +-------+------+------+-------+----+----+----+
  177.     | lharc |1.13c | e /c | e /cm | f  | d  | l  |
  178.     +-------+------+------+-------+----+----+----+
  179.     | larc  | 3.3  | e /c |e /c/o | f  | d  | l  |
  180.     +-------+------+------+-------+----+----+----+
  181.  
  182.     -----------------------------------------------------------------
  183.     Dwc and mdcd notes.
  184.  
  185.     +-------+------+----+-------+----+----+----+
  186.     |  pgm  | vers | xt | xt -o | fr | dl | vw |
  187.     +-------+------+----+-------+----+----+----+
  188.     |  dwc  |a5.01 | e  |  ew   | fz | d  | v  |
  189.     +-------+------+----+-------+----+----+----+
  190.     | mdcd  | 1.0  | d  |   r   |    |    | l  |
  191.     +-------+------+----+-------+----+----+----+
  192.  
  193.     -----------------------------------------------------------------
  194.     Zoo and looz notes.
  195.  
  196.     Xt and vw look first for looz.exe, then for zoo.exe if looz
  197.     is not found.
  198.  
  199.     Fr first directs zoo to freshen an archive, then to pack it.  Dl
  200.     first directs zoo to delete from an archive, then to pack it.
  201.  
  202.     % Fr and dl require one or more filename arguments.
  203.  
  204.     The utilities also operate upon bak archives created by zoo.
  205.  
  206.     +-------+------+----+-------+------+----+----+
  207.     |  pgm  | vers | xt | xt -o |  fr  | dl | vw |
  208.     +-------+------+----+-------+------+----+----+
  209.     |  zoo  | 2.01 | x  |  xSO  | auP: | DP | l  |
  210.     +-------+------+----+-------+------+----+----+
  211.     | looz  | 2.1  | x  |       |      |    | l  |
  212.     +-------+------+----+-------+------+----+----+
  213.  
  214.     -----------------------------------------------------------------
  215.     Shar and uudecode notes.
  216.  
  217.     These utilities are DOS ports of their Un*x namesakes.  Shar is
  218.     used on Un*x systems for concatenating source code and other text
  219.     files for electronic mail transfer.  Uudecode and its companion
  220.     utility uuencode are used to transfer binary files via electronic
  221.     mail.
  222.  
  223.     Xt should work fine with standard sh archives, as long as any
  224.     prepended text is less than 256 characters in length.  This limit
  225.     might be removed upon a showing of interest.
  226.  
  227.     When extracting from a sh archive, shar automatically overwrites
  228.     files of the same name if they exist in the target directory.
  229.     Thus, the command 'xt foo.sh bar.doc' will overwrite bar.doc if
  230.     it exists in the current directory.
  231.  
  232.     +--------+------------------------|----+
  233.     |  pgm   |        version         | xt |
  234.     +--------+------------------------+----+
  235.     |  shar  | unknown - 09/14/87     | -u |
  236.     +--------+------------------------+----+
  237.     |uudecode| Richard Marks - v3.07  | .  |
  238.     +--------+------------------------+----+
  239.  
  240.     -----------------------------------------------------------------
  241.     Tar and compress notes.
  242.  
  243.     These utilities are DOS ports of their Un*x namesakes.  They are
  244.     often used together for maximal compression, and are especially
  245.     useful for transferring files between DOS and Un*x.
  246.  
  247.     Compress requires about 450k of memory.  If less than 450k is
  248.     available, xt aborts with a status message.
  249.  
  250.     Compress cannot uncompress Z archives nondestructively.  Thus,
  251.     'xt foo.z' automatically overwrites 'foo' if it exists in the
  252.     current directory, as well as unlinking 'foo.z'.
  253.  
  254.     +--------+------------------------|------+-----+-----+
  255.     |  pgm   |        version         |  xt  |xt -o| vw  |
  256.     +--------+------------------------+------+-----+-----+
  257.     |  tar   | Eric Roskos - 10/24/88 | xfvk | xfv | tfv |
  258.     +--------+------------------------+------+-----+-----+
  259.     |compress| Pat Myrto - 06/19/88   | -dv  |     |     |
  260.     +--------+------------------------+------+-----+-----+
  261.  
  262.     -----------------------------------------------------------------
  263.     Unstufit and unpackit notes.
  264.     
  265.     These utilities are useful for transferring sit (stuffit) and pit
  266.     (packit) archives from the Macintosh O/S to DOS.
  267.  
  268.     For sit archives, xt and vw search first for unstufit.exe, then
  269.     for unsit.exe if unstufit is not found.
  270.  
  271.     +--------+------------------------|-----+----+
  272.     |  pgm   |        version         | xt  | vw |
  273.     +--------+------------------------+-----+----+
  274.     | unsit  | Brian Uechi - v2.3     |  e  | v  |
  275.     +--------+------------------------+-----+----+
  276.     |unstufit| Scott McGinnis - v1.0  | /de | v  |
  277.     +--------+------------------------+-----+----+
  278.     |unpackit| Scott McGinnis - v1.0  | /de | v  |
  279.     +--------+------------------------+-----+----+
  280.  
  281.     -----------------------------------------------------------------
  282.     Specific notes for mr.
  283.     -----------------------------------------------------------------
  284.     Two versions of mr are included: mn.com (for use with the device
  285.     driver nansi.sys), and ma.com (for use with ansi.sys).  Mn fully
  286.     exploits nansi's blazingly fast screen control and is highly
  287.     recommended.  Nansi.sys is readily available on many BBSs.
  288.  
  289.     The following discussion assumes one of the two versions has been
  290.     selected and renamed 'mr.com'.
  291.  
  292.     Mr is an improved version of the DOS 'more' utility.  It may be
  293.     used with vw to pause the display when viewing long archive file
  294.     lists.  For example:
  295.  
  296.         vw * | mr
  297.  
  298.         vw foo.zip | mr
  299.  
  300.         vw ??.lzh | mr
  301.  
  302.     Mr may also be used by itself as a simple text-viewing utility.
  303.     For example:
  304.  
  305.         mr foo.doc
  306.  
  307.     Although mr accepts DOS pathnames, it does not as yet accept
  308.     wildcards.
  309.  
  310.     The following commands may be issued at the '--More--' prompt:
  311.  
  312.         'l' or <cr> line-by-line scroll
  313.         'h' or 'd'  half-screen scroll (13 lines)
  314.         'f' or <sp> full-screen scroll (24 lines)
  315.         'k' or 'q'  keep screen and quit
  316.         'c' or 'x'  clear screen and quit
  317.  
  318.     Pressing any other key brings up a brief help menu.
  319.  
  320.     If 'mr' is entered without arguments, the computer will appear to
  321.     hang while mr waits for standard input.  Pressing f6 or ctrl-z
  322.     terminates mr and exits to DOS.
  323.  
  324.     The mr version id and usage message may be viewed with the command
  325.     'type mr.com' at the DOS prompt.
  326.  
  327.     -----------------------------------------------------------------
  328.     Utility history.
  329.     -----------------------------------------------------------------
  330.     compr20  05-30-90  Initial release of dl.com.
  331.                        Updated utilities for pkzip/unzip v1.1.
  332.                        Minor optimizations of fr.com.
  333.  
  334.     -----------------------------------------------------------------
  335.  
  336.     compr19  01-20-90  Reversed arc-format pak and pkarc/xarc
  337.                            precedence.
  338.                        Reversed zoo and looz precedence.
  339.                        Reversed unsit and unstufit precedence.
  340.  
  341.     -----------------------------------------------------------------
  342.     compr18  01-01-90  Added support for unsit v2.3.
  343.                        Removed support for pkzip/unzip v0.92.
  344.                        Improved xt and vw tar archive parsing
  345.                            routine to reduce number of false hits.
  346.  
  347.     -----------------------------------------------------------------
  348.     compr17  12-14-89  Added support for sh (shar), uue (uuencode),
  349.                            tar, Z (compress), sit (stuffit), and pit
  350.                            (packit) archives.
  351.                        Added standard key choices at 'mr' prompt.
  352.                        Added pak bypass based on available memory.
  353.                        Corrected parameter error in xt.
  354.                        Corrected name of larc.exe in fr and an error
  355.                            in 'lharc and larc notes'.
  356.                        Renamed mr_n.com 'mn.com', and mr_a.com
  357.                            'ma.com'.
  358.  
  359.     -----------------------------------------------------------------
  360.     compr16  08-26-89  Initial release of mr.com.
  361.                        Added support for larc v3.3.
  362.                        Concatenated usage message to version id.
  363.                        Corrected parsing of lzh archives.
  364.                        Made fr pkzip defaults user-configurable.
  365.                        Changed fr arc-format pak default to Crunch.
  366.                        Merged fr switch letters and operation.
  367.                        Removed fr switch letter configurability.
  368.                        Reversed fr arc-format pak and pkarc/xarc
  369.                            precedence.
  370.                        Adjusted fr zoo and looz precedence.
  371.                        Added history section to dox.
  372.  
  373.     -----------------------------------------------------------------
  374.     compr15  08-12-89  Added support for pkzip/unzip v1.0x.
  375.                        Added support for all pre-Crunch arc formats.
  376.                        Changed fr pkzip default to Implode for v1.01.
  377.                        Made fr pak v2.x default user-configurable.
  378.                        Added fr 'S' switch.
  379.                        Made fr switch letters user-configurable.
  380.                        Adjusted fr arc-format pak and pkarc/xarc
  381.                            precedence.
  382.                        Optimized utilities for A86 v3.21 assembler.
  383.  
  384.     -----------------------------------------------------------------
  385.     compr14  08-02-89  Added support for pak v2.x.
  386.                        Removed support for pkpak/unpak and tau.
  387.                        Added version id.
  388.                        Changed fr true-pak pak default to Distill for
  389.                            v2.x.
  390.                        Added fr 'C' switch.
  391.                        Adjusted fr zoo and looz precedence.
  392.  
  393.     -----------------------------------------------------------------
  394.     compr13  07-27-89  Modified error handling and display.
  395.                        Corrected parsing of Packed arc-format archives.
  396.  
  397.     -----------------------------------------------------------------
  398.     compr12  07-20-89  Added support for pkpak/unpak v3.61.
  399.                        Added fr 'c' and 's' switches.
  400.                        Changed fr pkzip v0.92 default to Reduce4.
  401.  
  402.     -----------------------------------------------------------------
  403.     compr11  07-11-89  Initial release of fr.com and vw.com.
  404.                        Fixed parsing of Squashed true-pak archives.
  405.                        Added archiver version and switch table to dox.
  406.  
  407.     -----------------------------------------------------------------
  408.        xt10  07-05-89  Initial release of xt.com.
  409.  
  410.     -----------------------------------------------------------------
  411.